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OBJECT-ORIENTED SYSTEM AND METHOD 
FOR HARDWARE CONFIGURATION 

BACKGROUND OF THE INVENTION 
Field of the Invention 
The present invention is generally directed to configuring hardware in a 
computer system, and more particularly to an object-oriented system and 
method for configuring hardware in a computer system. 

Related Art 

The phrase "hardware configuration" has many meanings. In the user 
domain of a computer system, hardware configuration refers to configuring 
computer components which are generally visible to users (this is called user- 
oriented hardware configuration). This includes tasks such as setting the 
double-click speed of a mouse, formatting a disk drive, connecting a modem to 
a serial port, or changing an existing connection. 

In the input/output (I/O) domain of a computer system, hardware 
configuration refers to low-level services which control or regulate access to 
integrated circuits (ICs) and other low-level hardware resources (this is called 
I/O hardware configuration). 

The present invention is primarily directed to user-oriented hardware 
configuration, but can be applied to other types of hardware configuration, such 
as I/O hardware configuration. 

Conventional computer systems distribute hardware configuration tasks 
among many different applications. For example, on the well-known Apple 
Macintosh computer, the Chooser application must be used to connect a 
StyleWriter printer to a modem port. To connect a modem to the modem port, 
a communication application (e.g. MacTerminal) must be used. To set up an 
Apple SCSI drive, the "Apple HD SC Setup" application must be used. To set 
the double-click speed of the mouse, the mouse control panel in the control 
panels folder must be used. As will be appreciated, it is difficult for users to 
keep track of where these configuration applications are maintained. Also, it is 
difficult for users to remember which configuration applications are required 
for the configuration of particular resources. 

Users must inform the computer of the location of some devices (that is, 
tell the computer how and where the devices are connected to the computer). 
These devices are called manually connected devices or manually configured 
devices, and require special attention with regard to hardware configuration. 
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When a manually connected device is attached to a computer, the 
computer cannot sense its presence. As an aspect of hardware configuration, 
some entity in the computer must be told (by a user) what kind of device it is 
and where it is connected. 
5 On the well-known Apple Macintosh System 7, the entity that is told 

depends on the type of the device in question. For example, the "Comm 
Toolbox" is used for modems and the Chooser is used for printers. 
Furthermore, the Comm Toolbox is port centric, not device centric (that is, the 
information saved by a document is about a port, not a device). If a user moves 
10 his modem to a different port, all of the terminal documents using that modem 
will not properly transmit when asked to do so, because they will expect the 
modem to be connected to the original port. 

Thus, what is required is a system and method for hardware 
configuration that does not suffer from the problems discussed above. 



15 



Summary of the Invention 
The present invention is directed to an object-oriented hardware 
configuration system for enabling centralized user configuration of hardware in 
a computer system. The hardware configuration system includes a plurality of 
20 object-oriented hardware interface objects each representing a hardware device 
physical connector, and a plurality of object-oriented hardware module objects. 

Each of the hardware module objects represents a hardware device that is 
user-configurable. Each of the hardware module objects includes one or more 
hardware interface objects associated with the hardware device such that 
25 connectors of the hardware device are defined. 

An object-oriented hardware configuration object is provided, wherein 
the hardware configuration object includes a plurality of hardware module 
objects that represent hardware devices connected to a particular computer 
system. The hardware configuration object defines a hardware configuration of 
30 the particular computer system. A user may access the hardware configuration 
object to configure the hardware devices connected to the particular computer 
system. 

The configuration system of the present invention supports centralized 
user configuration of hardware. Centralizing hardware configuration releases 
35 users from the burden of having to remember all of the different places 

hardware configuration tools can be located. For example, a computer viewer 
(discussed below), which is supported by the configuration system, is used to 
connect manually configured devices to the system. It provides access to 
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configuration utilities (for example, tools to format disk drives, change a 
monitor's bit-depth, etc.) for all local devices. It may also be used for choosing 
or directly using local services (e.g. local printers and modems). 

In the area of manually connected devices, the hardware configuration 
5 system offers special benefits. First, the system is used whenever a new device 
is added. This gives the system the option of automatically allocating the device 
if it so desires. Second, the system is empowered by the hardware configuration 
system to keep track of a device, even if it has moved to a different port. The 
user is not required to update all documents which use the affected device. 

10 Finally, a parts bin is supported, which collects all of the appropriate "installed" 
hardware resources the system is currently capable of supporting. The parts bin 
enables a user to find and connect a new device quickly using a hardware 
configuration viewer (e.g. the computer viewer). The parts bin is used for all 
manually connected devices. 

15 The hardware configuration system offers a number of innovative 

features. 

For example, the hardware configuration system manages a database of 
devices and their connections. The Hardware Configuration system records the 
existence, physical characteristics and connections of devices associated with a 

20 real hardware system. It allows clients to change connections and characteristics 
of these devices. For example, a personal computer consists of a computer and 
its peripherals. The existence and physical characteristics of the computer and 
its peripherals are recorded by a hardware database and users may change 
connections and add new or remove existing devices. The Hardware 

25 configuration system supports complex hardware systems which include switch 
boxes, multi-function cards, multi-slot cards, connections to more than one 
network (e.g. multiple network cards), multi-slot-type computers and expansion 
buses. 

The hardware configuration system supports refresh of configuration 
30 database. A service is provided which enables clients to manually make the 
database current. 

The hardware configuration system provides persistence for devices and 
their connections. When a device object is registered with the Hardware 
configuration system, the device object and its connection(s) can be saved. 
35 When restarted, all of these saved device objects will be automatically 

"restored" by the Hardware configuration system. The restored device objects 
behave the same as they did before the restart. 
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The hardware configuration system assists 
THardwarelnterfaceReferences in supporting device associations. Sufficient 
information is recorded to allow a THardwarelnterfaceReference object to 
automatically create a service for any connected device (manual or auto). The 
reference object remains valid even after the device's connection in the 
computer viewer has changed. 

The hardware configuration system provides notification. Notification is 
provided to any interested client when the state of an interesting hardware 
database changes (e.g. a device is added, removed, or connection changes). 
There is only one TInterest provided and that is: "something changed". 
Consequently, clients are only alerted that a change occurred and are not 
automatically given any additional details about the change. 

The hardware configuration system Supports a Hardware Configuration 
Viewer Framework. Clients can create their own hardware databases which can 
be built using the hardware configuration system of the present invention and 
displayed by the hardware configuration viewer framework. For example, a 
LaserWriter NTX configuration viewer can be created which would allow a user 
to see the hardware configuration of a remote LaserWriter (including its disk 
drives, connections, etc.). 
20 The hardware configuration system supports creation of device 

configuration viewers. Device configuration viewers enable a user to configure 
the "real device". Device configuration viewers are created by presentation 
objects. An entity of the operating system may create a presentation object using 
information obtained from a device object. For example, a configuration 
25 viewer for a disk drive will be created to reformat, partition, test, mount and 
unmount volumes for a drive. 

Further features and advantages of the present invention, as well as the 
structure and operation of various embodiments of the present invention, are 
described in detail below with reference to the accompanying drawings. 

30 

Brief Description of the Draxvings 
Figure 1 is a block diagram of a computer system in which the hardware 
configuration system in accordance with a preferred embodiment operates; 
Figure 2 is a class diagram of a hardware configuration framework 
35 according to a preferred embodiment in accordance with a preferred 
embodiment; 

Figure 3 is a diagram used to illustrate the operation of a 
THardwareConfiguration object in accordance with a preferred embodiment; 
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Figure 4 is a diagram used to illustrate the operation of a 
THardwareModule object in accordance with a preferred embodiment; 

Figure 5 is a diagram used to illustrate the operation of a 
THardwarelnterface object in accordance with a preferred embodiment; 
5 Figure 6 is a diagram used to illustrate the operation of a 

THardwarelnterfaceldentifier object in accordance with a preferred 
embodiment; and 

Figures 7A-7E are diagrams used to illustrate the manner in which a 
preferred embodiment operates during an example hardware configuration 
10 scenario. 



Detailed Discussion of the Preferred Embodiments 

15 The present invention is directed to an object-oriented system and 

method for configuring the hardware of a computer system. Since it is object- 
based, the present invention will be described herein using object-oriented 
terms and concepts. Such object-oriented terms and concepts are well known, 
and are discussed in many publicly available documents, such as Object- 

20 Oriented Design by Grady Booch (Benjamin Cummings 1991). 

Figure 1 illustrates a high-level block diagram of a computer system 102 
in which the object-oriented configuration system in accordance with a 
preferred embodiment operates. It should be noted that the present invention 
alternatively encompasses the configuration system in combination with the 

25 computer system 102. 

The computer system 102 includes hardware components 104, such as a 
random access memory (RAM) 108 and a central processing unit (CPU) 106. It 
should be noted that the CPU 106 may represent a single processor or multiple 
processors operating in parallel. 

30 The computer system 102 also includes peripheral devices which are 

connected to the hardware components 104. These peripheral devices include 
an input device or devices (such as a keyboard, a mouse, a light pen, etc.) 110, a 
data storage device 112 (such as a hard disk or floppy disk), a display 114, a 
printer 116, and a network adapter 118. The computer system 102 could be 

35 connected to other peripheral devices. 

The computer system 102 also includes an operating system 122, and may 
include microinstruction code 120 (also called firmware). The operating system 
122 may represent a substantially full-function operating system, such as the 
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Disk Operating System (DOS) and the UNIX operating system. The operating 
system 122 may alternatively represent other types of operating systems. 
Preferably, the operating system 122 represents a limited functionality operating 
system, such as the Mach micro-kernel developed by IBM, which is well-known 
to those skilled in the relevant art. 

In a preferred embodiment in accordance with a preferred embodiment, 
the computer system 102 is an International Business Machines (IBM) 
computer or an IBM-compatible computer. In an alternate embodiment in 
accordance with a preferred embodiment, the computer system 102 is an Apple 
computer. 

One or more programs 124 operate in parallel in the computer system 

102. 

Preferably, the object-oriented configuration system in accordance with a 
preferred embodiment is implemented as a collection of object-oriented objects 
which execute in the computer system 102. These objects are represented by one 
or more of the programs 124 which execute in the computer system 102. 

Alternatively, the objects could be implemented as part of the operating 
system 122 where the operating system 122 is object-oriented, rather than 
procedural based. Other methods of representing the configuration system in 
accordance with a preferred embodiment (as discussed herein) in the computer 
system 102 will be apparent to persons skilled in the relevant art. 

The objects which implement the configuration system in accordance 
with a preferred embodiment are instances of a plurality of object-oriented 
classes which are collected to form an object-oriented hardware configuration 
framework. This hardware configuration framework and the classes contained 
therein are discussed below. 

Before discussing the present invention in detail, it will be useful to 
define a few terms which are important for the understanding in accordance 
with a preferred embodiment. 

The first term is "auto configuration." There are two types of auto 
configuration. The first type is really more auto identifying than it is auto 
configuring. Devices falling into this category can identify themselves to the 
system. The system then turns around and looks for the required software, 
which in some cases must be manually "installed" by the user (see manual 
configuration below). The other form of auto configuration is self contained 
configuration. Devices falling into this category not only identify themselves, 
but can also provide their own configuration software and data. Auto 
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configuration is "Bottom Up". The system configures itself and it transfers 
information up to the top (the user). 

The second term is "manual configuration." Manual configuration 
requires the user to do something special (e.g. "install" a service or tell the 
5 computer where a device is connected). There are three cases of manual 
configuration. 

According to the first case, the device is identifiable by the system, but the 
required device service(s) can not be found. The user must manually "install" 
the service(s). This device is "software impaired". 

10 According to the second case, the required services are available, but the 

device is not detectable or identifiable by the system (i.e. its icon appears in the 
parts bin, but the device itself does not appear in the computer viewer). In this 
case, the user must drag the device from the parts bin to where the device is 
connected in the computer viewer. 

15 In the third case, the required services are not available nor is the device 

detectable. This is a partial combination of the two cases above. First, the user 
must "install" the service(s). Then he can drag the device from the parts bin to 
where the device is connected in the computer viewer. 
Manual configuration is "Top Down". The user supplies configuration 

20 information via some User Interface and this information percolates down to 
the bottom (the I/O system). 

The next term is "software impaired hardware." A hardware resource is 
deemed to be software impaired whenever the hardware resource is known to 
the system, but the system is unable to use it because the required software can 

25 not be found. A THardwareModule can represent impaired hardware. A 

THardwareModule may not become partially impaired. All software necessary 
to initialize a card must be available at the time the card THardwareModule is 
registered. Software impaired hardware is discovered on refresh or at boot time. 
The hardware configuration system in accordance with a preferred 

30 embodiment supports a hardware configuration viewer, which is preferably 
implemented using object-oriented techniques (such as being instances of 
related classes that form a framework). The hardware configuration viewer is 
described below. 

The hardware configuration viewer is a tool for displaying to a user a 
35 graphical representation of a computer's current hardware configuration. The 
hardware configuration viewer operates by using the parts bin (discussed 
below). There are many types of hardware configuration viewers. 
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For example, a computer viewer displays a graphical representation of 
the current configuration of an entire computer system. 

A printer viewer allows a user to see the configuration of a printer. For 
example, the printer viewer displays the hard disk drive(s) as well as optional 
5 attachments to the printer like a sheet feeder. The user could see what fonts the 
printer has (on the disk drive). 

A parts bin viewer presents to a user all the •'potentially" correctable 
"dumb" devices (like the Apple Chooser, only the Chooser shows some of the 
currently connected devices as well). The presentation by the parts bin viewer 
10 may include a window which has a tab for each device type. For example, tabs 
could be provided for printers and modems. The user selects a particular tab to 
see all the devices of a particular type. Thus, the Computer Viewer shows the 
user what is connected, whereas the parts bin viewer shows the user what can 
be connected. 

15 A device configuration viewer enables a user to configure a "real device" 

(that is, a physical device). Device configuration viewers are created by 
presentation objects. An entity of the operating system may create a 
presentation object using information obtained from a device object. For 
example, a configuration viewer for a disk drive will be created to reformat, 

20 partition, test, mount and unmount volumes for a drive. 

Architecture of the Hardware Configuration System 

As discussed above, the object-oriented configuration system in 
accordance with a preferred embodiment is implemented as a collection of 

25 object-oriented objects which execute in the computer system 102. These objects 
are instances of a plurality of related object-oriented classes which are collected 
to form an object-oriented hardware configuration framework. Figure 2 is a 
class diagram of this hardware configuration framework according to a 
preferred embodiment in accordance with a preferred embodiment. The classes 

30 which form the hardware configuration framework are discussed in the 
following sections. 

THardwareConfiguration 

The primary purpose of the THardwareConfiguration class 204 is to 
35 support centralized user configuration of hardware. It does this by providing a 
set of hardware related database services. THardwareConfiguration 204 owns a 
collection of THardwareModule objects. Clients may add new or remove 
existing THardwareModule objects from an instance of 
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THardwareConfiguration. Clients may directly retrieve from an instance of 
THardwareConfiguration, every THardwareModule object or specific kind(s) of 
THardwareModule objects (e.g. kind=printer, kinds=scanner & modem). 

Clients have access to a special THardwareConfiguration object, known as 
5 the ComputerHardwareConf iguration (also called the computer hardware 

database), which represents a personal computer's local hardware configuration. 
It includes devices such as the computer, mouse, keyboard and monitor. This 
database is the foundation of centralized user configuration of a personal 
computer. Figure 3 depicts an example ComputerHardwareConfiguration. 

10 With THardwareConfiguration objects, notification is sent to interested 

clients when any change is made to a hardware configuration (e.g. a hardware 
module is added or removed or a connection changed). Clients are only alerted 
that a change occurred and are not given any additional details about the 
change. Since changes to hardware configurations occur very infrequently, this 

15 minimal notification scheme is not expected to be a problem (e.g. noticeably 
increase interprocess communication, IPC, traffic). 

THardwareModule 

The purpose of a THardwareModule object 206 is to represent, at a very 
20 low level, a device which will be displayed by the hardware configuration 
viewer (or parts bin) and which will be configured or used by a user. 
THardwareModule objects 206 are used to represent computers, cards and 
peripherals. For example, each of the following would be represented by its 
own THardwareModule object: Apple Macintosh Ilci computer, Apple ADB 
25 keyboard, and Macintosh Video Card. 

As a member of THardwareConfiguration, a THardwareModule object 
206 represents a real device which a user may attempt to configure or use. As a 
member of a TPartLocator (i.e. parts bin 220, described below), a 
THardwareModule object 206 represents a prototype for any number of real 
30 devices with identical characteristics (i.e. a part which can be added to the 
system). 

A THardwareModule object 206 owns a set of ordered 
THardwarelnterface objects 212 (discussed below; THardwarelnterface objects 
212 are also called connector objects, or simply connectors, herein). Each 
35 THardwarelnterface object 212 corresponds to a real physical connector on a real 
device. For example, with reference to Figure 4, the THardwareModule object 
410 which represents the multi-function card 402 will own the 
THardwarelnterface objects 416, 414, and 412, respectively corresponding to the 
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following devices: one edge connector 404, a video connector 406 and a SCSI 
connector 408. 

Since THardwareModule is not required to be subclassed, the creator of a 
THardwareModule object must ensure that the appropriate THardwarelnterf ace 
objects are created and adopted into the THardwareModule object. 

Each THardwarelnterface object 206 corresponds to a 
THardwarelnterfaceldentifier object 224 (described below) and additionally 
corresponds to a connector object in a presentation object displayed by the 
computer viewer- 
One or more of the owned connectors is considered the default (see 
Figure 4; where the edge hardware object 416 is the default). Default connectors 
represent special connectors which are chosen as potential connection targets 
during drag and drop of devices onto connectors. This is a short cut for 
generating connections. The alternative is to drop the icon into a hardware 
viewer and then manually wire it to the proper connector. Example short cut 
method: A user drags the video-SCSI card, illustrated above, out of the parts bin 
and onto an ISA slot connector in the computer viewer. The computer viewer 
chooses the edge connector (over the SCSI or video connector) because the 
developer has specified the edge connector as the default. 

Sometimes more than one default connector is required. For example, a 
printer could have both a serial port and a parallel port. If the user dragged this 
printer over to the serial port, the computer viewer would test both default 
connectors for compatibility. It would discover that the printer was compatible 
with the serial port. The user could continue to drag the printer over to a 
parallel port. The computer viewer would discover that the printer was also 
compatible with that. 

Each THardwareModule object 206 has a personality-independent 
HardwareModuleSignature object 210 (discussed below) which identifies the 
class of physical hardware to which the THardwareModule object belongs to. 
For example, a THardwareModule object 206 which represents an Apple 
ImageWriter II will have an instance of HardwareModuleSignature 210 whose 
value is "ApplelmageWriterlT. 

Each THardwareModule object 206 has one or more 
HardwareModuleCategoiy objects 208 (discussed below). Each category object 208 
represents one particular kind of device that the THardwareModule object 206 is 
capable of representing. For example, a THardwareModule object 206 which 
represents a fax machine capable of being used as a modem, scanner, printer and 
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fax, will have one instance of each of the following HardwareModuleCategorys 
208: "modem", "scanner", "printer" and "fax". 

Typically, every THardwareModule object 206 in a hardware database is 
"connected" to at least one other THardwareModule object 206. However, this 
5 is not a requirement since a device may become completely disconnected for a 
variety of reasons. Disconnected devices in a THardwareConfiguration are still 
owned by the THardwareConfiguration object and are reachable by direct 
iteration. 

A THardwareModule object has a number of attributes, including "root," 
10 "internal," and "wants persistence." Root is a Boolean value. If true, then the 
THardwareModule object 206 is the central device of a 

THardwareConfiguration. Each THardwareConfiguration object 204 has one 

root device. For a personal computer database, the THardwareModule object 

206 which represents the computer is the root device. Root defaults to FALSE. 
15 The root device is a special device used by the Hardware Configuration Viewer. 

When the Abstract or Schematic view by the hardware configuration viewer is 

displayed, the root device is "exploded" into a special area. 

Internal is also a Boolean value. If true, then the real device is physically 

located inside of the root device. For example, the internal hard drive of a 
20 Macintosh is "inside" the computer. Defaults to FALSE. This state is used only 

by the computer viewer's schematic view. If a device is inside of the computer, 

it is displayed in a special area. 

"Wants persistence" is a Boolean value. A module that is not persistent 

is implicitly removed from the configuration when the system reboots (its 
25 connections are implicitly removed as well). On the other hand, a persistent 

module stays in the configuration through reboots, until it is explicitly 

removed. Typically, all manually connected devices will want to be 

automatically restored by the HW configuration framework and SCSI disk 

drives will not. Defaults to FALSE. 

30 

HardwareModuleCategory 

The purpose of HardwareModuleCategory 208 is to permit clients to 
group THardwareModule objects 206 by kind. An instance of 
HardwareModuleCategory 208 may be owned by a THardwareModule object 206 
35 or by a TPartLocator object 218 (discussed below). When owned by a 

THardwareModule object 206, an instance of HardwareModuleCategory 208 
represents a kind of device the module is capable of representing. Each 
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THardwareModule object 206 will have one HardwareModuleCategory object 
208 for each kind of device it can represent. 

When owned by a TPartLocator object 218, an instance of 
HardwareModuleCategory 208 represents the common group of all 
5 THardwareModule objects 206 owned by the TPartLocator object 218. 

Supported device categories include: Monitor, Printer, Keyboard, 
Pointing (mouse or tablet), Modem, Card, Disk drive, Scanner, FAX, etc. 

HardwareModuleSignature 

10 The purpose of HardwareModuleSignature 210 is to provide a mechanism 

which enables operating system (OS) personalities (e.g. OS/2) to create objects of 
their own to represent THardwareModule objects 206. This is required because 
THardwareModule objects 206 have no knowledge of what OS personalities 
reside above them. An instance of HardwareModuleSignature 210 represents a 
15 personality independent "key" to a unique personality dependent entity. For 
example, a particular operating system could use this key to resurrect a 
presentation object, corresponding to the HardwareModule object 206, from a 
file. Or, it could translate the signature into a presentation class name and then 
create a new presentation object corresponding to the THardwareModule object 
206. 

An instance of THardwareConfiguration 204 can include many devices 
with equivalent HardwareModuleSignature objects 210. For example, a database 
could have two 80MB Apple disk drives. Equivalent instances of 
HardwareModuleSignature 210 will exist, one for each THardwareModule object 
206. These are not the same devices. They are two different THardwareModule 
objects 206 representing two different real devices of the same type. 

THardwarelnterface 

The purpose of THardwarelnterface 212 is to represent, at a very low 
level, a real connector on a real device. It can represent a connector on the 
computer, a card or a peripheral. For example, each of the following would be 
represented by its own THardwarelnterface object 212: SCSI connector on a 
Macintosh nfx, video connector on a Macintosh video card or a serial connector 
on a StyleWriter. THardwarelnterface objects 212 are owned by 
THardwareModule objects 206. 

Each THardwarelnterface object 212 has one or more 
HardwarelnterfaceCateg ry objects 214 (described below). Each category object 
214 represents one particular kind of interface that the THardwarelnterface 
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object 212 is capable of representing. For example, a THardwarelnterface object 
212 which represents a serial port, will have one instance of each of the 
following HardwarelnterfaceCategory objects 214: "serial". 

Each instance of THardwarelnterface 212 will have one 
5 THardwareConnection object 216 (discussed below) for each THardwarelnterface 
object 212 to which it is connected. For example, as shown in Figure 5, a SCSI 
connector on the computer can be connected to a SCSI disk drive and a SCSI 
printer. The SCSI connector on the computer would have two 
THardwareConnection objects 216. The SCSI disk drive and the SCSI printer 
10 would each have one. 

Each instance of THardwarelnterface 212 will have one 
THardwarelnterf aceldentif ier object 224 (discussed below) which serves as a 
unique key into the database. 

Some THardwarelnterfaces 212 will represent an actual "interface port" 
15 (e.g. the SCSI port on a computer or the video port on a video card). These 
THardwarelnterfaces 212 can be used to start service stacks. 

Clients can request THardwarelnterface objects 212 to refresh. To 
accomplish this, a client (e.g. the computer viewer) creates a 
THardwarelnterfaceReference 222 with "MReconfigurablelnterface" as the top 
20 interface. If "MReconfigurablelnterface" is supported, a service will be returned 
when the hardware reference object 222 is activated and the client may safely 
call ReconfigureO on it. 

A side effect of allowing a THardwareModule object 206 to have more 
than one THardwarelnterface object 212 is that a connection may indirectly 
25 "loop" back to a device. If a client were attempting to traverse all of the 
connections of a device, he would need to be aware of potential loops. 

A THardwarelnterface object 212 has the following attributes: 

• Max connections: This is a short integer. A THardwarelnterface object 
30 212 may support one or more connections. This attribute specifies the 

maximum number of legal connections a THardwarelnterface object 212 
may have. Defaults to 1. 

• Mode: Possible values are In/Out/InOut. This specifies the 

35 transmission mode. A THardwarelnterface object 212 can be an input, an 

output or both. Defaults to InOut. 
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• Reconfigurable: This is a boolean value. If true, then the hardware can 
support refresh (i.e. it can probe to see if anything has changed). It does not 
mean that a service is available to actually perform the rescan. Defaults to 
FALSE. 

This attribute is only used as an optimization. Before a client attempts to 
refresh a port, it can first check to see if the hardware can support it. This 

same information can be determined by activating the 
THardwarelnterfaceReference 222 for the port. However, most hardware 

will not support reconfiguration and using property searches is slow. 

• Wants persistent Connections: This is a boolean value. The concept of 
persistence is the same as described for THardwareModule 206. A 

connector can request that its connection(s) be persistent. A connection will 
persist if either connector forming the connection makes this request. 
Defaults to FALSE. 

A connector which wants persistent connections implies that its device 
also wants persistence. If they do not agree, then an exception is generated. 

HardwarelnterfaceCategory 

The purpose of HardwarelnterfaceCategory 214 is to permit clients to 
group THardwarelnterface 212 objects by kind. For example, a client may want 
to find and group all of the serial ports for a given hardware configuration. An 
instance of HardwarelnterfaceCategory 214 represents a kind of interface a 
connector is capable of representing. Each THardwarelnterface object 212 will 
have one HardwarelnterfaceCategory object 214 for each kind of interface it can 
represent. The interface categories include: Serial, Parallel, Video, MIDI, ADB, 
SCSI and Slot. 

THardwareConnection 

The purpose of a THardwareConnection object 216 is to support distinct 
presentations for connections based on their state. An instance of 
THardwareConnection 216 represents a connection between two 
THardwarelnterface objects 212. 

A hardware connection object 216 has the following attributes: 
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• Kind: A connection may be automatic or manual. An automatic 
connection is made by the system. A manual connection is made by the 
user. It is important to be able to distinguish between these two types of 
connections. A user should not modify automatic connections. Hence, 

5 these connections are presented in such a way as to prevent users from 

changing them. Defaults to Automatic. 

• Wants Persistence: A boolean value. A derived attribute which is true 
if either connector wants persistent connections. 

A connection object 216 can be created if (1) the maximum number of 
connections is not exceeded on either one of the THardwarelnterface objects 212; 
(2) the "stack" of services between the two THardwarelnterface objects 212 is 
createable (or created). This means that the appropriate services must be 
installed before a user is allowed to connect a new device in his computer 
viewer; and (3) the modes of the two THardwarelnterface objects 212 are valid 
(using the table below): 





In 


Out 


In/Out 


In 


X 


Valid 


X 


Out 


Valid 


X 


X 


In/Out 


X 


X 


Valid 



20 

Table 1 

TPartLocator 

The purpose of TPartLocator 218 is to find all of the "installed" 
25 THardwareModule "prototypes" for a specific PartsBin category. As a member 
of a TPartsBin object 220, an instance of TPartLocator 218 represents the set of 
devices to be displayed by a PartsBin viewer, for a particular tab. Each 
TPartLocator object 218 has a BinCategory. The BinCategory specifies what 
kinds of devices the TPartLocator object 218 will find. For example, if the 
30 BinCategory ="Printer", then the TPartLocator object 218 will find all prototypes 
of printer "installed" on the system. When used by the parts bin, this bin 
category corresponds to a tab on the parts bin viewer. The parts bin viewer will 
own one TPartLocator for every tab it displays. 



10 



15 
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A TPartLocator object 218 refers to a set of Parts (i.e. THardwareModules 
206). Each part represents a device which the computer system is capable of 
supporting. For example, a printer TPartLocator object will own one prototype 
THardwareModule object for each type of printer found. 
5 A TPartLocator object 218 has the following additional behaviors: 

• All of the THardwareModule objects 206 owned by an instance of 
TPartLocator 218 belong to the same HardwareModuleCategory 208. 

10 • All of the THardwareModule objects 206 owned by an instance of 

TPartLocator 218 have unique HardwareModuleSignature objects 210. 

TPartsBin 

The purpose of TPartsBin 220 is to organize the plethora of manually 
15 configurable devices into meaningful sets of related devices. For example, 

instead of presenting the user with the complete list of every device which his 
system is capable of supporting, the Parts bin 220 organizes this set of devices 
into several lists, each list based on a device category. A TPartsBin object 220 
owns a set of Bin TPartLocator objects 218. Each bin represents a compartment 

20 and corresponds to exactly one tab on the parts bin viewer. The PartsBin viewer 
displays the contents of TPartLocator objects 218. As new "parts" are introduced 
into the system (i.e. installed), the appropriate TPartLocator objects 218 are 
updated. Furthermore, as new categories of "parts" are introduced, new 
TPartLocator objects 218 are created by the TPartsBin object 220 and new tabs are 

25 automatically displayed. User customizable locators are not excluded. 

The parts bin presents to the user all of the "potentially" connectable 
"dumb" devices (like the Apple Chooser, except the Chooser shows a few of the 
currently connected devices as well). The presentation consists of a window 
which has a tab for each device type. For example, tabs will be provided for 

30 printers and modems. The user selects a particular tab to see all the devices of a 
particular type. The user may drag a device out of the parts bin and to the 
computer viewer to connect it. 

The parts bin replaces that part of the Apple Chooser or similar entity 
where a user would select a printer and then click on the port the printer is 

35 connected to. It also replaces that part of MacTerminal or similar application 
where the user would select the port the modem is connected to. 

Every file which represents a prototype of a THardwareModule 206, and 
expects to be shown in the parts bin, must include one PartsBin 
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THardwareCategory property for every compartment the icon expects to appear 
in. 

A TPartsBin object 220 has the following additional behaviors: 

5 • The user may open any of the icons to specify persistent default settings. 

• An icon may belong to more than one parts bin category and hence may 
appear in more than one compartment of a parts bin. 

10 THardwarelnterfaceReference 

The purpose of THardwarelnterfaceReference 222 is to shield clients from 
the details of how a service for a local device is created. It encapsulates the 
details necessary to create the service (for example, what port the device is 
connected to)- It uses this information along with other information to build 
15 the appropriate service stack. The interface returned, as a result of creating the 
stack, is a strongly-typed interface to the desired service. This "top" interface is 
specified directly by the client. 

An instance of an active THardwarelnterfaceReference object represents 
access to a service provided by a real local device. 

20 

THardwarelnterfaceldentifier 

The purpose of THardwarelnterfaceldentifier 224 is to uniquely identify a 
real physical hardware component. THardwarelnterfaceldentifier objects 224 
are used by services and configuration access managers (CAMs) to get the 

25 physical information they require to actually drive the hardware (for example, a 
service may require the physical address of the chip, IRQ, byte-lane information, 
etc.). THardwarelnterfaceldentifier objects 224 are strongly typed so the service 
will know exactly what information is available and how to get it. 

As an example, the THardwarelnterfaceldentifier object, shown in Figure 

30 6, is for a serial THardwarelnterface object which is owned by a computer 

THardwareModule object. The THardwarelnterfaceldentifier object could be 
used by a service to get the physical I/O address of the SCC chip it represents. 

A Configuration Access Manager is an input /output system entity 
responsible for the initialization of system hardware resources. It is subclassed 

35 for each type of hardware resource. For auto-config devices, subclasses are 
responsible for finding live devices and starting their associated CAM's. A 
CAM may or may not automatically create and initiate an Access Manager (AM) 
for a device. For example, a SCSI CAM may create and initiate an AM for a SCSI 
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HD but not for a SCSI printer. AM's for printers are really not required until 
the printer is used. 

An Access Manager is an IO service which can talk directly to a chip. The 
AM handles arbitration between multiple requests to access the chip. 

5 

Operation in accordance with a preferred embodiment 
The operation in accordance with a preferred embodiment shall now be 
described by discussing the manner in which the present invention operates in 
a typical hardware configuration scenario. The operation in accordance with a 
10 preferred embodiment under different hardware configuration scenarios will be 
apparent to persons skilled in the relevant art based on the discussion contained 
herein. 

This scenario relates to the manual connection of a device. In this 
scenario, a user adds a new ISA serial card to his system and successfully boots. 

15 During the boot process, the ISA probe fails to find the card, so the card can not 
be used. Furthermore, the card is not displayed in the computer viewer. Its 
absence in the computer viewer is a hint to the user that the system does not see 
it. The user must teach his system about this new hardware module. He does 
this by using the computer viewer as supported by the hardware configuration 

20 system as shown in the following steps. 

(1) First, the user opens the computer viewer and the parts bin. Figure 
7 A is a partial illustration of the initial state of the computer hardware 
configuration and the parts bin. The computer hardware configuration is 
shown with one computer module which has an empty ISA slot. The parts bin 

25 has the ISA card we want to update the system with. 

(2) The user drags the ISA card icon from the parts bin over to any empty 
ISA slot icon on the computer (preferably the same slot it is really plugged into). 
The default connector is obtained from the card THardwareModule object (in 
this example it is the edge connector). Type negotiation between the two icons 

30 certifies that it is permissible for these two to be joined together. The standard 
negotiation process takes into account the invariants for connections as 
specified herein. 

(3) Now this card is connected to the slot. This is performed as follows. 
First, the computer viewer (via a command object) adds the card 

35 THardwareModule object to the ComputerHardwareConfiguration. This is 
depicted in Figure 7B. 

(4) Next, the connection must be connected. This is depicted in Figure 7C. 
There are two connector (i.e. THardwarelnterface) objects: one from the 
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computer viewer, chosen by the user, and one from the card, chosen by default. 
The command connects the two connectors together by creating a 
THardwareConnection. The final step is to call the Add method, on the 
connection, to consummate the connection. 
5 (5) The ComputerHardwareConfiguration now has a copy of the ISA card 

and is connected to the ISA slot. This is depicted in Figure 7D. 

(6) Any change to the hardware configuration results in a notification 
event which is sent to all interested clients. For example, the ISA configuration 
database is interested in manually connected ISA cards and receives 

10 notification. This is depicted in Figure 7E. In many cases, the new ISA card can 
be used as soon as the ISA database learns about it. However, if the ISA card 
CAM requires additional information (e.g. physical address, IRQ and/or DMA 
information), it may still be unavailable for use. The user may be required to 
supply this information to the card CAM. If so, then the ISA card icon should 

15 reflect the state (via a "software impaired" device icon or similar). 

Furthermore, a user alert may be generated to notify the user of this problem. 

Persistence of Handles 
This section describes the behaviors of handles as they relate to the 
20 master objects in a hardware configuration. The hardware configuration 

framework in accordance with a preferred embodiment provides all clients with 
persistent handles for the following: THardwareConfiguration 204, 
THardwareModule 206, THardwarelnterface 212 and THardwareConnection 
216. 

25 

Authentic and Dangling Handles 

Handles can be in one of two states, Authentic or Dangling. An authentic 
handle is a handle which refers to a master in the database. One gets an 
authentic handle by adding a master to the database, or by copying another 
30 authentic handle. A dangling handle is a handle which no longer refers to a 

master in the database. Dangling handles can be copied, but clients may not use 
dangling handles to actually read or write the master. 

Handle Transition 

35 A handle transitions from the authentic to dangling state if either of the 

following events occur. (1) Unbeknownst to one handle, the master is explicitly 
removed from the database by another handle. Or (2) the master is implicitly 
removed from the database as a result of reboot (because the master has been 
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marked as non-persistent). A handle transitions from the dangling to authentic 
state when a new master is added to the database that is "equivalent" to the 
(old) master that was referred to by the handle when it was in the authentic 
state. Equivalence is defined below. 

5 

Handle Equivalency 
The single THardwareConfiguration master per hardware configuration 
is implicitly marked persistent. THardwareConfiguration masters only go away 
when the database is destroyed. Handles referencing destroyed databases will 

10 dangle forever. Two configuration masters are never considered "equivalent", 
for the purposes of this section. A pair of THardwareModule masters are 
considered "equivalent" if (1) they have identical values for the Type attribute 
(THardwareModuleSignature), and (2) there is a one-to-one mapping between 
equivalent THardwarelnterface objects of the two module masters. 

15 A pair of THardwarelnterface masters are considered "equivalent" if (1) 

they belong to the same THardwareModule master, and (2) they have 
THardwarelnterfaceldentifiers that are considered "==". A pair of 
THardwareConnection masters are considered "equivalent" if the endpoints are 
themselves equivalent. 

20 

Concurrency of Handles 

This section describes the concurrency behaviors of handles provided by 
the hardware configuration framework in accordance with a preferred 
embodiment. The hardware configuration framework provides all clients with 

25 handles for the following: THardwareConfiguration, THardwareModule, 

THardwarelnterface and THardwareConnection. A handle is not multi-thread 
safe, except as follows: A method that operates on a master in a configuration 
database (as opposed to a reference counted master) is atomic with respect to 
other operations on the same master. In implementation terms, a handle does 

30 not have an internal monitor. A reference counted master also has no internal 
monitor. But, for a master in the configuration database, there is 
synchronization to ensure that at most one operation is being applied to a 
master at a time. 

35 Class Interfaces 

For illustrative purposes, additional details (such as the persistence of 
handles and the functionality of member functions) pertaining to selected 
classes of the hardware configuration framework (see Figure 2) are described 
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below. Such additional details for classes not specifically discussed below will be 
apparent to persons skilled in the art based on the discussion contained herein. 

THardwareConfiguration 

5 A THardwareConfigurationHandle 204 may be saved to a file and 

restored at anytime. The handle will continue to be valid until the Destroy 
method is called. The THardwareConfiguration class 204 includes the following 
functions. 

10 THardwareConfigurationHandleO 

Constructs a dangling Handle. Useful as a target for streaming and 
assignment. 

THardwareConf igurationHandle(const TText& name) 

15 Constructs a Handle to a master THardwareConfiguration object which is 

constructed using the persistent hardware configuration specified by the 
name argument. Many different THardwareConfigurations can exist 
concurrently, and this name is used to uniquely identify them. The name 
space is managed by attaching the manufacture's name to the beginning of 

20 the name argument. If a persistent hardware configuration is not wanted, 

then passing in an empty name (i.e. ""), will create a non-persistent, 
reference-counted hardware configuration. 

The persistent hardware configuration, specified by the name argument, 
25 contains all of the THardwareModule and THardwareConnection objects 

which requested persistence. 

All handles constructed for the THardwareConfigurationHandle named 
"Foo n , refer to the single master in the persistent hardware configuration 
30 named "Foo". 

THardwareConfigurationHandle(const THardwareConfigurationHandle& 
copyFrom 

Copies the handle, not the master. The new handle becomes a reference to 
35 the master referenced by copyFrom . 

THardwareConfigurationHandle& operators (const THardwareConfiguration 
Handle& copyFrom) 
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Copies the handle, not the master. 

~THardwareConfigurationHandle() 

Destroys the handle, not the master. 

5 

void DestroyO 

This method destroys the persistent store and all master objects in this 
hardware configuration. All handles to every object in this hardware 
configuration become dangling, including this one. 

10 

void GetAUHardwareModules(TCollection<THardwareModuleHandle>& 
result) const 

This method copies all of the handles which have been registered for this 
hardware configuration and adds them to the collection specified by the 
15 result argument. It does not empty the result first. 

The copied handles reflect the state of the master THardwareConfiguration 
object at the time this method was called. The state of the master 
THardwareConfiguration object can change at any time and will not be 
reflected by the result directly. Changes will be reflected by the handles in 
the result. For example, any handle whose master has been removed from 
its THardwareConfiguration object becomes a dangling handle. The only 
methods that may be applied to a handle in the dangling state are 
assignment, copy or streaming operators. A dangling handle becomes 
authentic when it is the target of assignment or streaming where the source 
is not dangling. 

void GetHardwareModules(TCollection<THardwareModuleHandle>& 
result,const HardwareModuleCategory& desiredKind) const 

This method copies all of the handles of the desiredKind which have been 
registered for this hardware configuration and adds them to the collection 
specified by the result argument; caller adopts the storage. It does not empty 
the result first. 

The copied handles reflect the state of the master THardwareConfiguration 
object at the time this method was called. 

void AddHardwareM dule(THardwareModuleHandle& newHardwareM dule) 
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This method adds the given newHardwareModule object to this hardware 
configuration. It does this by moving the master THardwareModule object 
referred to by newHardwareModule, and any THardwarelnterfaceHandle 
objects owned by newHardwareModule, into the hardware configuration. If 
5 the client owns handles to any THardwarelnterfaceHandle objects owned by 

newHardwareModule, they will be updated to reflect the move into the 
database. 

void RemoveHardwareModule(const THardwareModuleHandle& hardware 
10 Module) 

This method removes all THardwareConnection objects for each 
THardwarelnterface object owned by the master referred to by 
hardwareModule . Next, the master, is removed from the hardware 
configuration; the master becomes reference counted by this handle. All 
15 other handles that refer to the master become dangling. 

TInterest* CreateAnyChangelnterestO 

This method creates an interest in any change to the hardware configuration 
(which includes any change to any member of the hardware configuration); 
20 client adopts result storage. Notification is sent, by this 

THardwareConfiguration object, to all interested clients. Clients may call 
this method directly to create an interest which is used to register for 
notification. 

25 TStream& operator»=(TStream& toWhere) const 

Stream out a persistent reference to the master hardware configuration this 
handle represents. 

TStream& operator«=(TStream& fromWhere) 

30 Stream in a reference to a master hardware configuration. 



THardwareModule 

A THardwareModuleHandle may be saved to a file and restored at 
35 anytime. The handle will continue to be valid until the master is removed 
(via a RemoveHardwareModule method). The THardwareModule class 206 
includes the following functions. 
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THardwareModuleHandleO 

Creates a reference counted master not in any hardware configuration. 
THardwareModuleHandle(const THardwareModuleHandle& copyFrom) 
5 Copies the handle, not the master. The new handle becomes a reference to 
the master referenced by copyFrom . 

THardwareModuleHandle& operator=(const THardwareModuleHandle& 
copyFrom) 

10 Copies the handle, not the master. If the left-hand side is the last reference 

to a master not in any hardware configuration, then the master is destroyed. 
The left-hand side handle then becomes a reference to the master referenced 
by copyFrom. 

15 -THardwareModuleHandleO 

Destroys the handle. If this is the last reference to a master not in any 
hardware configuration, then the master is destroyed. 

void GetAllConnectors(TSequence<THardwareInterfaceHandle>& result) 
20 const 

This method copies all of the handles of THardwarelnterface objects owned 
by this THardwareModule and adds them to the collection specified by the 
lesaii argument; caller adopts the storage. It does not empty the result first. 
The connectors are added to the result in the same order they were added to 
25 the module (i.e. the first connector added will be the first connector returned 

from the TSequence iterator). 

The copied handles reflect the state of the master THardwareModule object 
at the time this method was called. The state of the master 
30 THardwareModule object can change at any time and will not be reflected by 

the result directly. Changes will be reflected by the handles in the result. 

This method may be called directly by clients at any time. Typically, the 
hardware viewer framework will call this method to map the connector 
« objects in a hardware module with the connector icons to be displayed. 

void GetDefaultConnectors(TSequence<THardwareInterfaceHandle>& result) 
const 
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This method copies all of the handles of THardwarelnterface objects owned 
by this THardwareModule which have been recorded as default connectors 
and adds them to the collection specified by the result argument; caller 
adopts the storage. It does not empty the result first. The connectors are 
5 added to the result in the same order they were added to the module. 

The copied handles reflect the state of the master THardwareModule object 
at the time this method was called. This method may be called directly by 
clients at any time. 

10 

void AddConnector(const THardwareInterfaceHandle& newConnector, 
Boolean isDefault = FALSE) 

This method moves the master THardwarelnterface object referred to by 
newConnector into the THardwareModule master. If the isDefault 
15 argument is true, then the newConnector is recorded as a default connector. 

This method is typically called when manually constructing a 
THardwareModule object from scratch. 

20 void RemoveConnector(const THardwarelnterf aceHandlefir connector) 

This method removes all connections associated with the given connector . 
Next, the master, specified by the connector argument, is removed from the 
hardware configuration; the master becomes reference counted by this 
handle. All other handles that refer to the master become dangling. 

25 

void GetSignature(HardwareModuleSignature& signature) const 

Copies a personality neutral entity, which represents the type of device this 
THardwareModule object represents, into the signature argument. This 
personality neutral entity can be used to create a personality dependent 
30 object (e.g. a presentation object). This method may be called directly by 

clients at any time. Typically, the computer viewer will call this method 
when constructing the presentation object for this hardware module for the 
first time. 

35 void SetSignature(c nst HardwareModuleSignature&) 

Sets the type this THardwareModule object represents. This method is called 
when manually constructing a THardwareModule object from scratch and 
will rarely be called by clients directly. 
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void GetCategories(TCollection<HardwareModuleCategory>& result) const 
This method copies all of the HardwareCategory objects owned by this 
THardwareModule and adds them to the collection specified by the result 
5 argument; caller adopts the storage. It does not empty the result first. 

The iterator reflects the state of the master THardwareModule object at the 
time this method was called. This method may be called directly by clients at 
any time. 

10 

void AddCategory (const HardwareModuleCategory& category) 

Appends the category argument to the end of the list of categories for this 
hardware module. This method is called when manually constructing a 
THardwareModule object from scratch and will rarely be called by clients 
15 directly. 

void DeleteCategory(const HardwareModuleCategory& category) 

Deletes the HardwareModuleCategory object, specified by the category 
argument, from the master THardwareModule. 

20 

Boolean IsRootO const 

Returns TRUE if this THardwareModule object is the central device of its 
THardwareConfiguration. Each THardwareConfiguration object has one 
root device. For a personal computer, the THardwareModule object which 
25 represents the computer is the root. 

void SetRoot(Boolean) 

Sets the "Root" attribute to the value of the given argument. This method is 
called when manually constructing a THardwareModule object from scratch 
30 and will rarely be called by clients directly. 

Boolean IsInternalO const 

Returns TRUE if this THardwareModule object is located inside of the root 
THardwareModule. This method is called by the configuration viewer to 
35 determine if it should draw the device inside or outside of the root device. 

For example, the internal HD of a Macintosh is "inside" the computer. 

void SetlnternaHB lean) 
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Sets the "internal" attribute to the value of the given argument. This 
method is called when manually constructing a THardwareModule object 
from scratch and will rarely be called by clients directly. 

Boolean WantsPersistenceO const 

Returns TRUE if this THardwareModule object wants the hardware 
configuration framework to automatically restore the device when the 
master THardwareConfiguration object is restored. This method is typically 
called by the hardware configuration framework (that is, by objects of the 
hardware configuration framework), 

void SetWantsPersistence(Boolean) 

Sets the "WantsPersistence" attribute to the value of the given argument. 
This method is called when manually constructing a THardwareModule 
object from scratch and will rarely be called by clients directly. 

TStream& operator»=(TStream& toWhere) const 

If a master THardwareModule object is in a hardware configuration, then 
this method streams out a persistent reference. Otherwise, this method 
streams out a copy of the master, including its connectors but not their 
connections. 

TStream& operator«=(TStream& fromWhere) 

Stream in a THardwareModuleHandle. If the object in the fromWhere 
argument is in a hardware configuration, then this method streams in a 
persistent reference. Otherwise, this method streams in a master, including 
its connectors. 

THardwarelnterface 

A THardwarelnterfaceHandle may be saved to a file and restored at 
anytime. The handle will remain valid until the master is removed. The 
THardwarelnterface class 212 includes the following functions. 

THardwarelnterfaceHandle () 

Creates a reference counted master not in any hardware configuration. 

THardwarelnterf aceHandle(c nst THardwarelnterf aceHandle& copyFr m) 
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Copies the handle, not the master. The new handle becomes a reference to 
the master referenced by copy From . 

THardwareInterfaceHandle& operators (const THardwareInterfaceHandle& 
5 copyFrom) 

Copies the handle, not the master. If the left-hand side is the last reference 
to a master not in any hardware configuration, then the master is destroyed. 
The left-hand side handle then becomes a reference to the master referenced 
by copvFrom. 

10 

-THardwarelnterfaceHandleO 

Destroys the handle. If this is the last reference to a master not in any 
hardware configuration, then the master is destroyed. 

15 THardwareModuleHandle GetOwnerO const 

Returns a handle to the THardwareModule object this THardwarelnterface 
object belongs to. This method is typically called by the hardware 
configuration viewer. 

void GetAUConnections(TColiection<THardwareConnectionHandle>& result) 
const 

This method copies all of the THardwareConnectionHandle objects 
associated with this THardwarelnterface and adds them to the collection 
specified by the result argument; caller adopts the storage. It does not empty 
the result first. 

The copied handles reflect the state of the master THardwarelnterface object 
at the time this method was called. This method is typically called by the 
hardware configuration viewer. 

void DeleteConnection(const THardwareInterfaceHandle& otherEnd) 

This method deletes the THardwareConnection object, specified by this 
object and the otherEnd , from this hardware configuration. All handles that 
refer to the master THardwareConnection object become dangling. 

v id DeleteAHConnectionsO 

This method deletes all of the THardwareConnections from this 
THardwarelnterface object. All handles that refer to the master 



9517715A1_L> 



WO 95/17715 



PCT/US94/03981 



-29- 

THardwareConnection objects deleted become dangling. This method is 
typically called by the hardware configuration viewer framework. 

THardwarelnterfaceldentifier* CopyHardwarelnterfaceldentifierO const 
5 Returns a pointer to the object which identifies the real physical hardware 

component this connector represents. Caller adopts returned storage. 

void SetHardwareInterfaceIdentifier(const THardwareInterfaceIdentifier&) 

Sets the "Interfaceldentifier" attribute to the value of the given argument. 
10 This method is called when manually constructing a THardwareModule 

object from scratch and will rarely be called by clients directly. 

short GetMaxConnectionsO const 

Returns the maximum number of connections allowed by this connector. If 
15 this value is greater than one, then the connector represents a bus (e.g. SCSI, 

ADB). This method is typically called by the hardware configuration viewer 
during connection negotiations. 

void SetMaxConnections(short) 

20 Sets the "MaxConnections" attribute to the value of the given argument. 

This method is called when manually constructing a THardwareModule 
object from scratch and will rarely be called by clients directly. 

ETransmissionMode GetModeO const 

25 Returns the transmission mode supported by this connector. This method is 

typically called by the hardware configuration viewer during connection 
negotiations. 

void SetMode(ETransmissionMode) 

30 Sets the "TransmissionMode" attribute to the value of the given argument. 

This method is called when manually constructing a THardwareModule 
object from scratch and will rarely be called by clients directly. 

Boolean WantsPersistentConnectionsO const 
35 Returns TRUE if this THardwarelnterface object wants the hardware 

configuration framework to automatically restore its connections when the 
master THardwareConfiguration object is restored. A connection will be 
restored if either connector forming the connection makes this request. 
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void SetWantsPersistentConnections(Boolean) 

Sets the "WantsPersistentConnections" attribute to the value of the given 
argument. This method is called when manually constructing a 
5 THardwareModule object from scratch and will rarely be called by clients 

directly. 

Boolean IsReconfigurableO const 

Returns TRUE if the hardware represented by this THardwarelnterface object 
can support reconfiguration. This does not mean that a service is currently 
available to actually perform the reconfiguration. This attribute is an 
optimization. 

void SetWantsReconfiuration(Boolean) 

Sets the "WantsReconfiguration" attribute to the value of the given 
argument. This method is called when manually constructing a 
THardwareModule object from scratch and will rarely be called by clients 
directly. 

void GetCategories(TCollection<HardwareInterfaceCategory>& result) const 

This method copies all of the HardwareCategory objects owned by this 
THardwarelnterface and adds them to the collection specified by the result 
argument; caller adopts the storage. It does not empty the result first. 

The iterator reflects the state of the master THardwarelnterface object at the 
time this method was called. This method may be called directly by clients at 
any time. 

void AddCategory(const HardwareInterfaceCategory& category) 

Appends the category argument to the end of the list of categories for this 
hardware interface. This method is called when manually constructing a 
THardwarelnterface object from scratch and will rarely be called by clients 
directly. 

void DeleteCategory(c nst HardwareInterfaceCategory& categ ry) 

Delete the HardwarelnterfaceCategory object, specified by the category 
argument, from the master THardwarelnterface. 
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TStream& operator»=(TStream& t Where) const 

If a master THardwarelnterface object is in a hardware configuration, then 
this method streams out a persistent reference. Otherwise, this method 
streams out a copy of the master. 

5 

TStream& operator«=(TStream& fromWhere) 

Stream in a THardwarelnterfaceHandle. If the object in the fromWhere 
argument is in a hardware configuration, then this method streams in a 
persistent reference. Otherwise, this method streams in a master. 

10 

THardwareConnectionHandle 

A THardwareConnectionHandle may be saved to a file and restored at 
anytime. The handle will remain valid until the master is removed. The 
THardwareConnection class 216 includes the following functions. 

15 

THardwareConnectionHandleO 

Creates a dangling handle. Useful as a target for streaming and assignment. 

THardwareConnectionHandle(const THardwareInterfaceHandle& 
20 toConnector,const THardwareInterfaceHandle& fromConnector) 

Creates a reference counted master not in hardware configuration. 

THardwareConnectionHandle(const THardwareConnectionHandle&c copy 
From) 

25 Copies the handle, not the master. The new handle becomes a reference to 

the master referenced by copyFrom . 

THardwareConnectionHandlefe operator= (const THardwareConnection 
Handle& copyFrom) 

30 Copies the handle, not the master. If the left-hand side is the last reference 

to a master not in any hardware configuration, then the master is destroyed. 
The left-hand side handle then becomes a reference to the master referenced 
by cppyFrom. 

35 -THardwareC nnecti nHandleO 

Destroys the handle. If this is the last reference to a master not in any 
hardware configuration, then the master is destroyed. 
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void Add() 

This method moves the master THardwarelnterfaceConnection object into the 
hardware configuration. No connector sees this connection until Add is called. 

5 void RemoveO 

This method reverses the effects of doing an Add. The master 
THardwareConnection object is removed from the hardware configuration; 
the master becomes reference counted by this handle. All OTHER handles 
that refer to the master become dangling. This method is typically called by 
10 the hardware configuration viewer. 

THardwarelnterfaceHandle GetOtherEnd(const THardwareInterfaceHandle& 
thisEnd) const 

Given the THardwarelnterfaceHandle, specified by thisEnd. this method 
15 returns the THardwarelnterfaceHandle at the other end. 

EConnectionKind GetKindO const 

Returns the kind of connection this THardwareConnection object 
represents. A connection may be automatic or manual. An automatic 
20 connection is made by the system. A manual connection is made by the 

user. It is important to be able to distinguish between these two kinds of 
connections. This method is typically called by the hardware configuration 
framework. 

25 void SetKind(EConnectionKind) 

Sets the "kind" attribute to the value of the given argument. This method is 
called when manually constructing a THardwareModule object from scratch 
and will rarely be called by clients directly. 

30 Boolean IsPersistentO const 

Returns TRUE iff either connector of this THardwareConnection object 
wants persistent connections. This method is typically called by the 
hardware configuration framework. 

35 TStream& operat r»=(TStream& toWhere) const 

If in a hardware configuration, then this method streams in a persistent 
reference. Otherwise, this method streams out a copy of the master. 



<WO 9517715A1_I_> 



WO 95/17715 



PCT/US94/03981 



-33- ' 

TStream& operator«=(TStream& fromWhere) 

Stream in a THardwareCpnnectionHandle. If the object in the fromWhere 
argument is in a hardware configuration, then this method streams in a 
persistent reference. Otherwise, this method streams in a master. 

5 

TPartLocator 

A TPartLocator object may not be saved. The TPartLocator class 218 
includes the following member functions. 

10 TPartLocator(const HardwareModuleCategory& theCompartment) 

Creates a part locator capable of finding all of the hardware module 
prototypes (i.e. parts) specified by theCompartment . The only expected client 
of this constructor is TPartsBin. TPartsBin will create one of these locators 
for every compartment (i.e. tray, bin, tab, etc.) the parts bin will have. 

15 

Boolean FindAll(TCollection<THardwareModuleHandle>& theResult) 

This method finds all the FSEntities which identify themselves as parts that 
want to be in this compartment. It resurrects all of the 
THardwareModuleHandle objects from the located files and adds them to 
20 the given collection specified by theResult: caller adopts the storage. It does 

not empty theResult first. It returns TRUE if it found anything. The parts 
bin will call this when it needs to display (or prepare to display) the contents 
of a particular compartment. 

25 THardwareModuleHandle FindOne(const TText& theName) 

This method returns the THardwareModuleHandle "installed" for this 
compartment whose HardwareModuleSignature matches theName , 

TInterest* CreateAddedlnterestO 

30 This method creates an interest for clients to use to register for notification 

on the addition of any part which belongs to this compartment; client adopts 
result storage. The only expected client of this method is TPartsBin. 
TPartBin will call this method just before it calls FindAll, so it can ensure an 
up-to-date display of the available parts. 

35 

TInterest* CreateRemovedlnterestO 

This method creates an interest for clients to use to register for notification 
on the removal of any part which belongs to this compartment; client adopts 
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result storage. The only expected client of this method is TPartsBin. 
TPartsBin will call this method just before it calls FindAU, so it can ensure 
an up-to-date display of the available parts. 

TPartsBin 

A TPartsBin object may not be saved. The TPartsBin class 220 includes the 
following member functions. 

TPartsBinO 

Constructs an empty parts bin. 

TPartsBin(const TPartLocator& copyFrom) 

Copies all of the TPartLocators owned by copyFrom into this TPartsBin. 

void GetAUPartLocators(TCollection<TPartLocator>& result) const 

This method copies all of the TPartLocator objects in this parts bin and adds 
them to the collection specified by the result argument; caller adopts the 
storage. It does not empty the result first. 

The contents of the parts bin object can change at any time, but this will not 
be directly reflected by the iterator. This method may be called directly by 
clients at any time. The only expected client of this method is the parts bin 
viewer. It will display an icon (and name) for every part locator it owns. 
Each part locator represents a tab on the parts bin. Furthermore, when a tab 
is selected by the user, the parts bin viewer will display all of the parts for 
that compartment. 

TPartLocator GetPartLocator(const HardwareModuleCategory& desired 
Compartment) const 

Returns the TPartLocator object for the desiredCompartment in this parts 
bin. This method may be called directly by clients at any time. 

void AddCompartmentFor (const HardwareModuleCategory& compartment) 

This method creates a TPartLocator object for the kind of compartment 
specified by the compartment argument for this parts bin. This method may 
be called directly by clients at any time. The only expected client of this 
method is a parts bin viewer. A parts bin viewer can decide which categories 
it wants to display. 
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void RemoveCompartment (const HardwareModuleCategory& compartment) 

This method removes the TPartLocator object for the kind of compartment 
specified by the compartment argument for this parts bin. The only expected 
5 client of this method is the parts bin viewer. 
TInterest* CreateAddedlnterestO 

This method creates an interest for clients to use to register for notification 
on the addition of any new part locator. The only expected client of this 
method is a parts bin viewer. The parts bin viewer will call this method just 

10 before it calls GetAllPartLocators, so it can ensure an up-to-date display of the 

available compartments. 
TInterest* CreateRemovedlnterestO 

This method creates an interest for clients to use to register for notification 
on the removal of an existing part locator. The only expected client of this 

15 method is a parts bin viewer. The parts bin viewer will call this method just 

before it calls GetAllPartLocators, so it can ensure an up-to-date display of the 
available compartments. 

While various embodiments in accordance with a preferred embodiment 
20 have been described above, it should be understood that they have been 

presented by way of example only, and not limitation. Thus, the breadth and 
scope in accordance with a preferred embodiment should not be limited by any 
of the above-described exemplary embodiments, but should be defined only in 
accordance with the following claims and their equivalents. 
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What is claimed is: 

1. An object-oriented hardware configuration system for enabling 
centralized user configuration of hardware in a computer system, 
comprising: 

a plurality of object-oriented hardware interface objects each representing 
a hardware device physical connector; 

a plurality of object-oriented hardware module objects each representing 
a hardware device that is user-configurable and comprising one or more 
hardware interface objects associated with the hardware device such that 
connectors of the hardware device are defined; 

an object-oriented hardware configuration object comprising a plurality 
of hardware module objects that represent hardware devices connected to 
a particular computer system, such that the hardware configuration 
object defines a hardware configuration of the particular computer 
system; and 

means for enabling a user to access the hardware configuration object to 
configure the hardware devices connected to the particular computer 
system. 

1. The hardware configuration system of claim 1, further comprising means 
for notifying interested clients of changes in the hardware configuration 
of the particular computer system by transmitting to the interested clients 
notification of changes in the hardware configuration object. 

The hardware configuration system of claim 1, wherein the hardware 
module objects belong to device classes, and wherein the hardware 
module objects comprise object-oriented hardware module signature 
objects to identify the device classes. 

The hardware configuration system of claim 1, wherein the hardware 
module objects comprise object-oriented hardware module category 
objects for identifying device types which the hardware module objects 
can represent. 
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4 5. The hardware configuration system of claim 4, wherein the device types 

5 comprise a monitor type, a printer type, a keyboard type, a pointing 

6 device type, a modem type, a card type, a disk drive type, a scanner type, 

7 and a facsimile device type. 

1 6. The hardware configuration system of claim 1, wherein the hardware 

2 interface objects comprise object-oriented hardware interface category 

3 objects for identifying device connector types which the hardware 

4 interface objects can represent. 

1 7. The hardware configuration system of claim 6, wherein the device 

2 connector types comprise a serial connector type, a parallel connector 

3 tyP e / a video connector type, a MIDI connector type, an ADB connector 

4 tyP e / a SCSI connector type, and a slot connector type. 

1 8. The hardware configuration system of claim 1, wherein the hardware 

2 interface objects represent computer system interface ports. 

1 9. The hardware configuration system of claim 1, wherein the hardware 

2 interface objects, the hardware module objects, and the hardware 

3 configuration object are instances of related object-oriented classes which 

4 form an object-oriented framework. 
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15 10. A computer system, comprising: 

16 a computer; 

17 a plurality of user-configurable hardware devices connected to the 

18 computer; and 

19 an object-oriented hardware configuration system, executing in the 

20 computer, for enabling centralized user configuration of the hardware 

21 devices, comprising 

22 a plurality of object-oriented hardware interface objects each 

23 representing a hardware device physical connector, 

24 a plurality of object-oriented hardware module objects 

25 representing the hardware devices, the hardware module objects each 

26 comprising one or more of the hardware interface objects such that 

27 connectors of the hardware devices are defined by the hardware module 

28 objects, 

29 an object-oriented hardware configuration object comprising the 

30 hardware module objects, wherein the hardware configuration object 

31 defines a hardware configuration of the computer system, and 

32 means for enabling a user to access the hardware configuration 

33 object to configure the hardware devices. 

1 11. The computer system of claim 10, wherein the hardware configuration 

2 system further comprising means for notifying interested clients of 

3 changes in the hardware configuration of the computer system by 

4 transmitting to the interested clients notification of changes in the 

5 hardware configuration object. 

1 12. The computer system of claim 10, wherein the hardware module objects 

2 belong to device classes, and wherein the hardware module objects 

3 comprise object-oriented hardware module signature objects to identify 

4 the device classes. 

1 13. The computer system of claim 10, wherein the hardware module objects 

2 comprise object-oriented hardware module category objects for 

3 identifying device types which the hardware module objects can 

4 represent. 
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1 14. The computer system of claim 13, wherein the device types comprise a 

2 monitor type, a printer type, a keyboard type, a pointing device type, a 

3 modem type, a card type, a disk drive type, a scanner type, and a facsimile 

4 device type. 

1 15. The hardware configuration system of claim 10, wherein the hardware 

2 interface objects comprise object-oriented hardware interface category 

3 objects for identifying device connector types which the hardware 

4 interface objects can represent. 

1 16. The hardware configuration system of claim 15, wherein the device 

2 connector types comprise a serial connector type, a parallel connector 

3 type/ a video connector type, a MIDI connector type, an ADB connector 

4 typ e / a SCSI connector type, and a slot connector type. 

1 17. The hardware configuration system of claim 10, wherein the hardware 

2 interface objects represent computer system interface ports. 

1 18. The hardware configuration system of claim 10, wherein the hardware 

2 interface objects, the hardware module objects, and the hardware 

3 configuration object are instances of related object-oriented classes which 

4 form an object-oriented framework. 
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